package com.smart.community.user.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.smart.community.user.entity.Permission;
import com.smart.community.user.dto.PermissionDTO;
import com.smart.community.user.dto.PermissionQueryDTO;
import com.smart.community.user.vo.PermissionVO;
import com.smart.community.commons.result.PageResult;

import java.util.List;

/**
 * 权限服务接口
 * 
 * @author Wu.Liang
 * @since 2024-12-21
 */
public interface PermissionService extends IService<Permission> {

    /**
     * 分页查询权限列表
     *
     * @param queryDTO 查询条件
     * @return 分页结果
     * @throws Exception 统一异常
     */
    PageResult<PermissionVO> getPermissionList(PermissionQueryDTO queryDTO) throws Exception;

    /**
     * 根据ID查询权限
     *
     * @param id 主键ID
     * @return 权限信息
     * @throws Exception 统一异常
     */
    PermissionVO getPermission(Long id) throws Exception;

    /**
     * 新增权限
     *
     * @param permissionDTO 权限信息
     * @throws Exception 统一异常
     */
    void createPermission(PermissionDTO permissionDTO) throws Exception;

    /**
     * 更新权限
     *
     * @param id 主键ID
     * @param permissionDTO 权限信息
     * @throws Exception 统一异常
     */
    void updatePermission(Long id, PermissionDTO permissionDTO) throws Exception;

    /**
     * 删除权限
     *
     * @param id 主键ID
     * @throws Exception 统一异常
     */
    void deletePermission(Long id) throws Exception;

    /**
     * 更新权限状态
     *
     * @param id 主键ID
     * @param status 状态
     * @throws Exception 统一异常
     */
    void updatePermissionStatus(Long id, Integer status) throws Exception;

    /**
     * 获取权限树
     *
     * @param status 状态（可选）
     * @return 权限树
     * @throws Exception 统一异常
     */
    List<PermissionVO> getPermissionTree(Integer status) throws Exception;

    /**
     * 获取用户权限
     *
     * @param userId 用户ID
     * @return 权限列表
     * @throws Exception 统一异常
     */
    List<PermissionVO> getUserPermissions(Long userId) throws Exception;

    /**
     * 获取完整权限树（用于权限分配）
     *
     * @param status 状态（可选）
     * @return 完整权限树
     * @throws Exception 统一异常
     */
    List<PermissionVO> getCompletePermissionTree(Integer status) throws Exception;

    /**
     * 获取角色权限
     *
     * @param roleId 角色ID
     * @return 权限列表
     * @throws Exception 统一异常
     */
    List<PermissionVO> getRolePermissions(Long roleId) throws Exception;



    /**
     * 根据角色ID查询权限列表
     * 
     * @param roleId 角色ID
     * @return 权限列表
     * @throws Exception 统一异常
     */
    List<Permission> getPermissionsByRoleId(Long roleId) throws Exception;

    /**
     * 根据用户ID查询权限列表
     * 
     * @param userId 用户ID
     * @return 权限列表
     * @throws Exception 统一异常
     */
    List<Permission> getPermissionsByUserId(Long userId) throws Exception;

    /**
     * 检查用户是否有指定权限
     * 
     * @param userId 用户ID
     * @param permissionCode 权限编码
     * @return 是否有权限
     * @throws Exception 统一异常
     */
    boolean hasPermission(Long userId, String permissionCode) throws Exception;

    /**
     * 获取当前登录用户的菜单权限
     * @return 菜单权限列表
     * @throws Exception 统一异常
     */
    List<String> getCurrentUserMenuPermissions() throws Exception;
} 